chore: create Plan category with JTBD and CQA 2.1 compliance#3099
Closed
gtrivedi88 wants to merge 1 commit into
Closed
chore: create Plan category with JTBD and CQA 2.1 compliance#3099gtrivedi88 wants to merge 1 commit into
gtrivedi88 wants to merge 1 commit into
Conversation
gtrivedi88
requested review from
a team,
deerskindoll and
mkuznyetsov
as code owners
|
Click here to review and test in web IDE: |
-525C86?logo=eclipse-che&labelColor=red){kind=icon}
|
🎊 Navigate the preview: https://6a063cc152484fc29c7b4fde--eclipse-che-docs-pr.netlify.app 🎊 |
Move resource planning and CLI tool content out of Administration Guide into a new top-level Plan module, following the JTBD category restructure: Discover → Plan → Install → Administer. - Create modules/plan/ with nav, pages, examples, and images - Move calculating-che-resource-requirements, running-at-scale, and installing-the-chectl-management-tool to Plan module - Add WHY-first JTBD abstracts and [role="_abstract"] blocks - Add :page-aliases: for backward-compatible URL redirects - Update 16 cross-module xrefs across admin-guide, overview, and partials - Register Plan module in antora.yml nav Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
gtrivedi88
force-pushed
the
jtbd-plan-category
branch
from
f8fec79 to
483683d
Compare
gtrivedi88
added a commit
to gtrivedi88/che-docs
that referenced
this pull request
May 14, 2026
Move all installation pages, partials, and examples from administration-guide to a new modules/install/ module, matching the downstream JTBD category structure. Create installation overview, verification, and next-steps pages. Update all cross-module xrefs and includes across admin-guide, overview, and end-user-guide. Delete dissolved wrapper pages (preparing-the-installation, permissions-to-install-che). Register discover, plan, and install module navs in antora.yml. Depends on: PR eclipse-che#3098 (Discover), PR eclipse-che#3099 (Plan) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
5 tasks
gtrivedi88
added a commit
to gtrivedi88/che-docs
that referenced
this pull request
May 14, 2026
Move all installation pages, partials, and examples from administration-guide to a new modules/install/ module, matching the downstream JTBD category structure. Create installation overview, verification, and next-steps pages. Update all cross-module xrefs and includes across admin-guide, overview, and end-user-guide. Delete dissolved wrapper pages (preparing-the-installation, permissions-to-install-che). Register discover, plan, and install module navs in antora.yml. Depends on: PR eclipse-che#3098 (Discover), PR eclipse-che#3099 (Plan) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
gtrivedi88
added a commit
to gtrivedi88/che-docs
that referenced
this pull request
May 14, 2026
Move all installation pages, partials, and examples from administration-guide to a new modules/install/ module, matching the downstream JTBD category structure. Create installation overview, verification, and next-steps pages. Update all cross-module xrefs and includes across admin-guide, overview, and end-user-guide. Delete dissolved wrapper pages (preparing-the-installation, permissions-to-install-che). Register discover, plan, and install module navs in antora.yml. Depends on: PR eclipse-che#3098 (Discover), PR eclipse-che#3099 (Plan) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
gtrivedi88
added a commit
to gtrivedi88/che-docs
that referenced
this pull request
May 18, 2026
Move all installation pages, partials, and examples from administration-guide to a new modules/install/ module, matching the downstream JTBD category structure. Create installation overview, verification, and next-steps pages. Update all cross-module xrefs and includes across admin-guide, overview, and end-user-guide. Delete dissolved wrapper pages (preparing-the-installation, permissions-to-install-che). Register discover, plan, and install module navs in antora.yml. Depends on: PR eclipse-che#3098 (Discover), PR eclipse-che#3099 (Plan) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
gtrivedi88
added a commit
to gtrivedi88/che-docs
that referenced
this pull request
May 18, 2026
Move calculating-che-resource-requirements, running-at-scale, and installing-the-chectl-management-tool from administration-guide into the install module. This merges what was planned as a separate Plan module (PR eclipse-che#3099) directly into Install, matching the downstream decision to retire the Plan guide. - Move 3 pages, 4 examples, 1 image to modules/install/ - Add running-at-scale to install/nav.adoc Requirements section - Update admin-guide nav to remove moved entries - Convert cross-module xrefs: admin-guide refs to install become local - Add plan: page-aliases for backward-compatible redirects Co-authored-by: Cursor <cursoragent@cursor.com>
Contributor
Author
|
Closing this PR. The Plan content (calculating-che-resource-requirements, running-at-scale, installing-the-chectl-management-tool) has been merged directly into the Install module in PR #3102 instead of creating a separate Plan module. Rationale: The Plan guide contained only pre-installation infrastructure preparation content (resource sizing, scaling, CLI tooling). This fits naturally in the Install module's Requirements section rather than justifying a standalone top-level module. This aligns with the downstream decision to retire The |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
calculating-che-resource-requirements.adoc,running-at-scale.adoc, andinstalling-the-chectl-management-tool.adocout of the Administration Guide intomodules/plan/[role="_abstract"]blocks per CQA 2.1:page-aliases:for backward-compatible URL redirectsContext
This is the second PR in the JTBD category restructure series:
Test plan
detect-unused-content.shpasses (no orphaned pages/examples/images):page-aliases:🤖 Generated with Claude Code